# | README file for | | ELSA graphics driver disk for Windows NT 4.0 build 1381. | | Copyright (c) 1993-97 ELSA GmbH, Aachen (Germany) | | Subsidary: | ELSA GmbH ELSA Inc. | Sonnenweg 11 2231 Calle de Luna | D-52070 Aachen Santa Clara CA 95131 | Germany USA | | Phone : +49-241-606-0 Phone: +1-408-935-0350 | Support Fax: +49-241-606-6399 Phone: 1-800-272-ELSA | BBS (modem): +49-241-606-9800 Fax : +1-408-935-0370 | BBS (ISDN) : +49-241-606-9820 BBS : +1-408-935-0380 | CompuServe : GO ELSA CIS : GO ELSA | WWW : http://www.elsa.de WWW : http://www.elsa.com | | | June, 5th 1997, FNicklis/Cschalle/MHodshon Table of Contents: 1 Introduction 2 List of Files 3 Installation 4 Additional Configuration Options 5 Known Problems ------------------------------------------------------------------------ 1 Introduction This file helps you with the installation of your ELSA graphics adapter. It explains how to setup the ELSA WINNER driver and check if it has been installed properly. 1.1 Requirements This software runs on any ELSA PCI bus graphics card. 1.2 Further Information For more information on configuring installed ELSA display drivers, refer to the Windows help or the help files shipped with the ELSA utilities. ------------------------------------------------------------------------ 2 List of Files NOTE Not all of the files listed below can be used by your graphic adapters. Some utilities need specialized adapter capabilities and hardware. The directory with the ELSA graphics driver for Windows NT contains the following files: DISK1 Identifier for the first disk DISK2 Identifier for the second disk DISK3 Identifier for the third disk ELSA.HLP ELSA help file ELSA.INF Script file for Microsoft setup program LIESMICH.TXT German version of the file README.TXT README.TXT This file SETUP.EXE Setup utility SETUP.INI Setup configuration file TXTSETUP.OEM Script file for text setup while booting Machine-dependent files will be found in directories named .\I386\, .\ALPHA\ or .\PPC\: Graphics display drivers: WINNER.SYS Miniport driver WINNER.DLL Display driver WINNERMB.DLL Multi-display driver ELSAOGL.DLL OpenGL driver Utilities: Subdirectory Dxctrl: CYLINDER.X Data file for DirectX Control DXCTRL.DLL DirectX Control property page DXCTRL.INF Script file for Microsoft setup program ELSA2.PPM Data file for DirectX Control GLOBE.PPM Data file for DirectX Control RAST1.PPM Data file for DirectX Control SPHERE3.X Data file for DirectX Control Subdirectory Glset: GLSET.DLL GLoria Settings property page GLSET.INF Script file for Microsoft setup program GLSET.TEX Data file for GLoria Settings GLSETENG.HLP English GLoria Settings help file GLSETDEU.HLP German GLoria Settings help file GLSETRAY.EXE GLoria Settings Tray utility Subdirectory Videoctr: VIDEOCTR.EXE Video Control application VIDEOCTR.INF Script file for Microsoft setup program ------------------------------------------------------------------------ 3 Installation NOTE This driver was designed for full functionality under Windows NT 4.0 only! The typical installation procedure as described in the Microsoft Windows NT manual is used to install the driver. There are several ways to install an ELSA display driver: - Run the ELSA Setup utility (3.1) - Change the display driver using the display properties (3.2) - Text setup during the NT system installation (3.3) 3.1 Running the ELSA Setup Utility This Setup utility allows you to install the display driver automatically. To run SETUP.EXE you can either double click on it in the Microsoft Explorer or choose >>Run...<< in the >>Start<< menu of the taskbar. 3.1.1 Additional Configuration Options The Auto Setup utility SETUP.EXE reads the file SETUP.INI in which some options may be defined. The section [Setup Options] provides the following keys: - QuietInstall=ON/OFF; ON: SETUP.EXE installs the graphics display driver without requesting user input. (default: OFF) - AutoReboot=ON/OFF; ON: After copying the files the machine is rebooted to complete the installation. (default: OFF) The section [Tools] provides an "InstallableFiles" key. This provides a list of all the installation script files additional installation when choosing "Install ELSA graphics display drivers and utilities". These installation script files provide a [DefaultInstall] and [DefaultUninstall] section, so that they can be easily uninstalled/installed using "Add/Remove Programs, Install/Uninstall..." in the control panel. 3.1.2 Options and Comments - Before running the Auto Setup utility close all running programs and the >>Display Properties<< window. - Auto Setup only supports Windows NT 4.0 build 1381 in the English and German languages. - SETUP.EXE can be called with a suffixed parameter. This has to be the path and the name of an .INF file. Example: SETUP.EXE D:\WINNER\3000M\WINNT40\ELSA.INF - When more than one Adapter is supported by the .INF file the first item displayed in the Install list box will be installed. 3.2 Change the Display Driver using the Display Properties (Manual Installation) 3.2.1 Installing the ELSA Display Driver You can install a graphics driver using the Display Properties sheet. Open the Display Property sheet and select the page >>Settings<<, click on >>Display Type...<< to open the dialog window of the same name and select >>Change...<< in the Adapter Type frame. The >>Change Display<< dialog opens. Don't look in the Manufacturer's or Display list! NOTE The entry >>Elsa WINNER 1000<< in this listbox will install the general purpose (and less than optimal) S3 driver designed by Microsoft. The entries in the Manufacturer's >>S3<< list can be used but do not always work properly. General purpose drivers are installed here as well! Click the button >>Have Disk...<< to install the ELSA drivers. Windows NT prompts you to enter the disk with the driver or browse for the path. Select >>Browse...<< when installing from CD-ROM and locate the file ELSA.INF for the driver suitable for your hardware. When installing from floppy disk, insert the first driver disk. Select the >>OK<< button. A list box appears. Here, choose the entry matching your graphics adapter and click >>OK<<. Confirm the >>Third-party Drivers<< dialog with >>Yes<<. The driver files and utilities are now copied and installed to your hard disk. When installing from floppies, the >>Insert Disk<< dialog prompts you when the disk has to be changed. The >>Installing Driver<< window informs you that the driver has been installed. Confirm this message and close all display settings windows until you are asked to reboot your computer. NOTE With Windows NT 4.0, graphic drivers cannot be loaded dynamically. This is not an ELSA limitation. To activate the ELSA driver the computer has to be restarted. Please press >>Yes<< in the >>System Settings Change<< dialog. When you've selected to restart, the system will reboot and the initial installation is finished. NOTE Windows NT 4.0 will now restart in a resolution of 640*480 pixel at 256 colors and 60Hz refresh, unless you have updated your driver in which case the previous resolution is taken over. Refer to your Windows NT Help on how to change the display properties settings. After Windows NT is restarted, the dialog >>Registry Editor<< informs you that some information has been entered into the registry. This was done to install the display property pages. Simultaneously the Display Properties sheet opens with the >>Settings<< page and a dialog >>Invalid Display Settings<< which tells you that a new driver was installed and that you have to select your preferred display resolution. 3.2.2 Manual Installation of ELSA Utilities The ELSA utilities can be easily installed from the Explorer by clicking on the appropriate .INF file with the right mouse button (see 2) and then selecting "Install...". NOTE: For deinstallation, choose "Add/Remove Programs" in Control Panel and select the utility you want to uninstall. 3.3 Text Setup During System Installation NOTE: You will need the installation disks (see 3.4). The Windows NT Setup is a text based program for installing Windows NT. During this setup the Screen shows the text >>Windows NT Workstation Setup Setup has determined that your computer contains the following hardware and software components.<< followed by a list of components. The topic >>No Changes: The above list matches my computer<< is highlighted. DO NOT press ENTER ! Move the highlight to >>Display: Auto Detect<< and press ENTER. You are now able to select a display from the shown list. NOTE We recommend you select >>Standard VGA (640x480, 16 colors)<< now and continue with paragraph 3.2 at a later stage when Windows NT is installed properly! You cannot install from CD-ROM now. You will need installation floppy disks to set up the drivers. For information about how to create driver installation disks from your CD-ROM read paragraph 3.4. To install an ELSA display driver select >>Other (Requires disk provided by a hardware manufacturer)<<. You will be prompted to insert a manfacturer-supplied hardware support disk into the floppy drive. Insert disk 1, and press ENTER. Select an entry matching your system: >>ELSA i386 640 x 480, 256 colors<< for Intel-based machines, >>ELSA Alpha 640 x 480, 256 colors<< for DEC Alpha machines, >>ELSA PPC 640 x 480, 256 colors<< for PowerPCs. Accept the list if it matches your computer. Continue the installation following all instructions. You will be prompted for each ELSA installation disk in turn. During the installation you will have to restart your computer, which will be booted in graphics mode. The page >>Display properties<< is then displayed where you can change the default resolution. Don't forget to view the test screen before pressing OK! The Windows NT Setup continues and then reboots the system with the resolution you have selected. NOTE: After Installation, the ELSA utilities need to be installed manually as described in (3.2.2). 3.4 Installation Disks Installation disks can be created by copying files from the WINNERware CD-ROM or from a downloaded file onto diskettes. You will need three empty disks labeled "ELSA Windows NT 4.0 DISK 1", "ELSA Windows NT 4.0 DISK 2" and "ELSA Windows NT 4.0 DISK 3". Copy the following files from CD-ROM to: - Disk 1 ("ELSA Windows NT 4.0 DISK 1"): DISK1 ELSA.INF ELSA.HLP LIESMICH.TXT README.TXT SETUP.EXE SETUP.INI TXTSETUP.OEM I386\WINNER.SYS I386\WINNER.DLL I386\WINNERMB.DLL - Disk 2 ("ELSA Windows NT 4.0 DISK 2"): DISK2 ELSA.INF TXTSETUP.OEM I386\ELSAOGL.DLL I386\GLSET\GLSET.DLL I386\GLSET\GLSET.INF I386\GLSET\GLSET.TEX I386\GLSET\GLSETDEU.HLP I386\GLSET\GLSETENG.HLP I386\GLSET\GLSETRAY.EXE - Disk 3 ("ELSA Windows NT 4.0 DISK 3"): DISK3 ELSA.INF TXTSETUP.OEM I386\DXCTRL\CYLINDER.X I386\DXCTRL\DXCTRL.DLL I386\DXCTRL\DXCTRL.INF I386\DXCTRL\ELSA2.PPM I386\DXCTRL\GLOBE.PPM I386\DXCTRL\RAST1.PPM I386\DXCTRL\SPHERE3.X I386\VIDEOCTR\VIDEOCTR.EXE I386\VIDEOCTR\VIDEOCTR.INF For Alpha or PowerPC Installation disks, replace the I386\ folder with the ALPHA\ or PPC\ folder and files from CD-ROM. 3.5 Check if the Installation was Successful There are various possibilities to read the version number of the ELSA Windows NT graphics driver and to determine whether the installation was carried out properly. 3.5.1 Display Properties Open the Display Properties window as described in your Windows NT manual. Select the >>Settings<< page and click on >>Display Type<<. The dialog >>Display Type<< gives information about the installed adapter, the current display driver and the hardware recognized by the driver. 3.5.2 Checking the Driver Files Use the Explorer to inspect the file properties for one of the files WINNER.SYS, WINNER.DLL, or WINNERMB.DLL. The files can be found in the directory System32\Drivers and System32 of your Windows NT. ------------------------------------------------------------------------ 4 Additional Configuration Options 4.1 How to Configure the Driver In the following, ELSA graphics driver settings for Windows NT and the corresponding entries in the registry database are explained. Changes can be made with the ELSA utility GLoria Settings or manually with the registry editor. NOTE Inexperienced users should not make any changes to the registry directly! 4.1.1 GLoria Settings The ELSA GLoria Settings property page allows you to configure the 3D options on ELSA GLoria graphics adapters. 4.1.2 DirectX Settings For graphics adapters supporting Direct Draw, the ELSA DirectX settings property page allows you to configure the Direct Draw options. Direct3D is not currently supported by Windows NT. 4.1.3 Video Control The ELSA Video Control utility allows you to configure the video output on WINNER 1000 TRIO T2D and VICTORY 3DX graphics adapters. 4.1.4 Registry Editor Windows NT stores its configuration information in a database that is organized in a tree-like format. The Registry Editor enables you to inspect and modify the Registry. To run Registry Editor, activate REGEDT32.EXE from the SYSTEM32 directory. The entries for the ELSA WINNER graphics driver are placed in the window HKEY_LOCAL_MACHINE in the path HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WINNER\. 4.2 Multiscreen Options Some ELSA graphics adapters can be used in a multiscreen mode. Two or more adapter cards and the same number of monitors are driven from one computer. This will result in an enlarged desktop. A list with graphics adapters that support multiscreen is found in 4.2.3. 4.2.1 Installing Multiscreen There is no special Multiscreen installation. After placing a second ELSA graphics adapter into your computer, the "Display" utility in the Control Panel offers you a new extended resolution. NOTE There is no special information indicating that Multiscreen is enabled. This is only apparent from the extended resolutions available. 4.2.2 Configuration of the Multiscreen Mode The entries "DesktopOnMaximize" and "ReverseScreenOrder" in the registry database influence the multiscreen operation. 4.2.2.1 DesktopOnMaximize This switch adjusts how dialogs and windows are displayed on the multiple ("N") screens. 0x0: When maximizing a window it will be displayed only on the left screen. Dialogs appear on the left screen. Advantage: Dialogs and windows aren't split by screen borders. Disadvantage: Dialogs always appear left, even if the application runs on the right screen. Position settings of MDI-applications (e.g. Microstation) will be lost after restarting the program. 0x1: When maximizing a window it fills out all screens. Advantage: Position settings of MDI-applications (e.g. Microstation) will be restored after a restart. Disadvantage: Dialogs and windows may be displayed on screen borders. 4.2.2.2 ReverseScreenOrder This entry reverses the order of the N screens. NOTE "Reverse screen order" in the MonCtrl utility. 0x0: The order of the adapters is 1, 2, ..., N 0x1: The order of the adapters is N, ..., 2, 1 4.2.3 Supported Graphic Adapters Currently, only combinations of identical ELSA graphics adapters from the following list are supported: WINNER 1000 AVI WINNER 2000 Pro/X WINNER 3000 M WINNER 3000 L GLORIA 4 GLORIA 8 GLORIA M GLORIA L NOTE You can only use adapters with identical memory equipment. 4.3 Gloria/OpenGL Settings The following descriptions are only meant for the ELSA Gloria 4/8 graphic adapters. They belong to the 3D extensions supported by the OpenGL graphics interface. NOTE For all entries there is a description in the "GLoria Options" frame of the GLoria Settings utility. 4.3.1 ICD Extensions The following parameters of the Installable Client Driver (ICD) affect the behavior of the GLoria's 3D functions. 4.3.1.1 ICDInterface.Disable This switch enables or disables ICD driver's OpenGL support. NOTE "Disable 3D-Extensions" in GLoria Settings. 0x0: OpenGL will be supported by the Gloria (default). 0x1: Software OpenGL (no GLint) or OpenGL using 3D-DDI 4.3.1.2 ICDInterface.ExportAlpha Allows the hardware to use the software's alpha channel. With programs which don't use the alpha channel this can cause a performance loss of up to 25 %. NOTE "Use alpha channels" in GLoria Settings. 0x0: The driver doesn't export an alpha channel (default). 0x1: The driver exports an alpha channel. 4.3.1.3 ICDInterface.NumberOfDisplayBuffers This switch enables and disables Double Buffering. The entry stands for the number of buffers. NOTE "OpenGL buffers" in GLoria Settings. 0x1: Only one display buffer is used; no Double Buffering. 0x2: Double Buffering enabled (default). 4.3.1.4 ICDInterface.SizeOfBuffer This is used to control the size in longs of the shared memory block allocated to each individual rendering context. This buffer is used when DMA is disabled or the entire DMA buffer is in use. This change will take effect after the next restart. NOTE "Interface buffer size" in GLoria Settings. Valid values: 0x100 to 0x10000, the default is 0x10000 (64 kB). 4.3.1.5 ICDInterface.SupportSingleBufferedGDI This flag decides how GDI and OpenGL commands are handled in the same window in the front buffer. NOTE "GDI in single buffered modes" in GLoria Settings. 0x0: GDI commands cannot be drawn in OpenGL windows. 0x1: OpenGL and GDI can simultaneously use the front buffer (default). 4.3.1.6 ICDInterface.SupportDoubleBufferedGDI Lets OpenGL export the ability to allow OpenGL and GDI to draw in the back buffer. NOTE "GDI in double buffered modes" in GLoria Settings. 0x0: GDI commands cannot be drawn in OpenGL windows (default). 0x1: OpenGL and GDI can simultaneously use the back buffer. (recommended for 3D Studio MAX) NOTE The flag is exported but all GDI calls are drawn in the front buffer! 4.3.1.7 ICDInterface.SupportOverlayPlanes This switch enables the driver to support overlay planes, which are used for example by Softimage. NOTE "Support Overlay Planes" in GLoria Settings. 0x0: No support for overlay planes (default). 0x1: Overlay planes are supported. 4.3.1.8 ICDInterface.VBlankWait This switch enables the driver to turn on the wait for vertical blanks when swapping OpenGL buffers. NOTE >>Wait on Vertical Blank<< in GLoria Settings. 0x0: Swap buffers is not syncronized with vertical blank (default). 0x1: The driver waits for vertical blanks. 4.3.1.9 ICDInterface.PageFlipping In True Color the driver provides a page-flipping mode when swapping OpenGL buffers instead of blitting. 0x0: Don't use page flipping. 0x1: Driver uses page flipping instead of blits when possible (default). 4.3.2 GLint-DMA settings The parameters of the GLintDMA group configure the DMA capabilities of the GLint. 4.3.2.1 GLintDMA.NumberOfBuffers This is used to determine the number of individual DMA buffers in use at any one time. This change will take effect after the next restart. NOTE "DMA buffers" in GLoria Settings. Valid values: 0x0 to 0x4, the default is 0x4. 4.3.2.2 GLintDMA.NumberOfSubBuffers Used to control the ICD drivers subdivision of the DMA buffer. NOTE "DMA subbuffers" in GLoria Settings. Valid values: 0x0 to 0x9, the default is 0x5. 4.3.2.3 GLintDMA.SizeOfBuffer This is the total size of the DMA buffer which is divided among the individual processes using DMA. This change will take effect after the next restart. NOTE "DMA buffer size" in GLoria Settings. Valid values: 0x100 to 0x10000, the default is 0x8000 (32 kB). 4.3.2.4 GLintDMA.CachedBuffers This switch enables the driver to cache GLint data in the processor's cache. Although the GLint reads all data from the main memory, differences between memory and cache can occur. This change will take effect after the next restart. NOTE "Cached DMA" in GLoria Settings. 0x0: forces uncached DMA 0x1: forces cached DMA 0x2: let the driver decide whether it uses cached or non- cached DMA (default). 4.3.3 OpenGL.UseFastClear This value affects the usage of fast clear planes. When running multi-threaded applications it may be necessary to disable the unseen of the fast clear planes. This change will take effect after the next restart. NOTE "Use Fast Clear Pages" in GLoria Settings. 0x0: Fast clear planes disabled. 0x1: Fast clear planes enabled NOTE For MicroStation this switch has to be set! 4.3.4 OpenGL.UseHiQualityTexture This switch affects the precision and resolution for texture mapping. 0x0: Normal precision and resolution 0x1: High precision and resolution 4.3.5 OpenGL.SupportSoftimage This switch fixes corrupted menu and window borders in Softimage 3.01. Use this switch only when running Softimage 3.01! NOTE "Support Softimage" in GLoria Settings. 0x0: Softimage fix not activated (default) 0x1: Softimage fix is active. 4.3.6 OpenGL.SupportSoftimage351 This switch enables functions designed especially for Softimage 3.51. Use this switch only when running Softimage 3.51! NOTE "Support Softimage 3.51" in GLoria Settings. 0x0: Softimage 3.51 fix not activated (default) 0x1: Softimage 3.51 fix is active. 4.3.7 OpenGL.DisableMipMaps This switch allows the user to force rendering performance when using textures by disabling the mipmaping. This overrules every application's OpenGL commands for texture filtering, and leads to a loss in accuracy. NOTE Slider "Texture Quality" in GLoria Settings. 0x0: Mip-Mapping is enabled 0x1: Mip-Mapping is disabled 4.3.8 OpenGL.TextureCompression This value is used to reduce the texture size actually downloaded to the texture memory on the graphics board by simply shrinking the texture. This will enhance the rendering performance, but at the same time leads to a loss in accuracy. NOTE Slider "Texture Quality" in GLoria Settings. 0x0: No texture compression 0x1: Texture compression by 1/4 0x2: Texture compression by 1/16 0x3: Texture compression by 1/64 4.4 Additional Options 4.4.1 EnableDeviceBitmaps This value is used to turn the usage of device bitmaps on and off. When enabled, the driver supports higher performance. 0x0: Device Bitmaps disabled 0x1: Device Bitmaps enabled (default) 4.5 ELSA POWERlib ELSA offers the toolkit POWERlib as an option for the programmer. This is for creating your own applications using the ELSA graphics board for graphical output. This tool is available for Windows NT. ------------------------------------------------------------------------ 5 Known Problems - If the application under OpenGL requests "Double Buffering" and the GLoria cannot realize it (1024x768x32 bpp), software emulation will be installed automatically. To force hardware OpenGL you have to disable double buffering in your application! - The driver cannot run on a system where a port COM4 is installed. - Don't use the standard S3 display driver. While Setup is detecting your computer's hardware, choose Cancel to avoid the installation of the S3 driver. - No mouse cursor: You have installed the S3 driver shipped with Windows NT. - When running an OpenGL application and switching from DOS box to DOS fullscreen and back, the OpenGL application crashes. The same happens when changing the Display Properties. In these cases, the driver has been initialized by Windows NT which causes a loss of important information for running the OpenGL tasks. - Installing the driver from diskettes as described in the >>Text Setup<< paragraph doesn't acivate all 3D and Direct Draw settings. You have to install the driver again after the Windows NT setup is finished. - If the ELSA graphics board is not recognized, try another PCI slot. Some board manufacurers have implemented PCI slots that are not PCI compliant. ------------------------------------------------------------------------